home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / t_sndudata.z / t_sndudata
Encoding:
Text File  |  2002-10-03  |  9.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. tttt____ssssnnnndddduuuuddddaaaattttaaaa((((3333NNNN))))                                                  tttt____ssssnnnndddduuuuddddaaaattttaaaa((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa - send a data unit
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.      _####_eeee_llll_ssss_eeee
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_uuuu_ssss_eeee_rrrr_...._hhhh_>>>>
  16.      _####_eeee_nnnn_dddd_iiii_ffff
  17.  
  18.      _iiii_nnnn_tttt _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa _((((_iiii_nnnn_tttt _ffff_dddd_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa _****_uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa_))))_;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      This function is used in connectionless mode to send a data unit to
  22.      another transport user.  _ffff_dddd identifies the local transport endpoint
  23.      through which data will be sent, and _uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa points to a _tttt______uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa
  24.      structure containing the following members:
  25.  
  26.           _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _aaaa_dddd_dddd_rrrr_;;;;
  27.           _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _oooo_pppp_tttt_;;;;
  28.           _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _uuuu_dddd_aaaa_tttt_aaaa_;;;;
  29.  
  30.      _nnnn_eeee_tttt_bbbb_uuuu_ffff is described in _iiii_nnnn_tttt_rrrr_oooo(3N).  In _uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa, _aaaa_dddd_dddd_rrrr specifies the
  31.      protocol address of the destination user, _oooo_pppp_tttt identifies protocol-
  32.      specific options that the user wants associated with this request, and
  33.      _uuuu_dddd_aaaa_tttt_aaaa specifies the user data to be sent.  The user may choose not to
  34.      specify what protocol options are associated with the transfer by setting
  35.      the _llll_eeee_nnnn field of _oooo_pppp_tttt to zero.  In this case, the provider may use default
  36.      options.
  37.  
  38.      If the _llll_eeee_nnnn field of _uuuu_dddd_aaaa_tttt_aaaa is zero, and the sending of zero bytes is not
  39.      supported by the underlying transport provider, _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa will return -1
  40.      with _tttt______eeee_rrrr_rrrr_nnnn_oooo set to _TTTT_BBBB_AAAA_DDDD_DDDD_AAAA_TTTT_AAAA.
  41.  
  42.      By default, _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa operates in synchronous mode and may wait if flow
  43.      control restrictions prevent the data from being accepted by the local
  44.      transport provider at the time the call is made.  However, if _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or
  45.      _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is set (via _tttt______oooo_pppp_eeee_nnnn or _ffff_cccc_nnnn_tttt_llll), _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa will execute in
  46.      asynchronous mode and will fail under such conditions.
  47.  
  48.      If _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa is issued from an invalid state, or if the amount of data
  49.      specified in _uuuu_dddd_aaaa_tttt_aaaa exceeds the _TTTT_SSSS_DDDD_UUUU size as returned in the _tttt_ssss_dddd_uuuu field of
  50.      the _iiii_nnnn_ffff_oooo argument of _tttt______oooo_pppp_eeee_nnnn or _tttt______gggg_eeee_tttt_iiii_nnnn_ffff_oooo, the provider will generate an
  51.      _EEEE_PPPP_RRRR_OOOO_TTTT_OOOO protocol error.  (See _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR below.)  If the state is invalid,
  52.      this error may not occur until a subsequent reference is made to the
  53.      transport endpoint.
  54.  
  55.      This function resides within both the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt and the
  56.      SVR4 compliant _llll_iiii_bbbb_nnnn_ssss_llll Network Services libraries.  Network Services
  57.      applications which require X/Open compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  58.      Network Services applications which require SVR4 compliance must link-
  59.      load with _----_llll_nnnn_ssss_llll.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tttt____ssssnnnndddduuuuddddaaaattttaaaa((((3333NNNN))))                                                  tttt____ssssnnnndddduuuuddddaaaattttaaaa((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to one of the following:
  75.  
  76.      _TTTT_BBBB_AAAA_DDDD_FFFF             The specified file descriptor does not refer to a
  77.                        transport endpoint.
  78.  
  79.      _TTTT_FFFF_LLLL_OOOO_WWWW             _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK was set, but the flow control
  80.                        mechanism prevented the transport provider from
  81.                        accepting data at this time.
  82.  
  83.      _TTTT_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP_PPPP_OOOO_RRRR_TTTT       This function is not supported by the underlying
  84.                        transport provider.
  85.  
  86.      _TTTT_OOOO_UUUU_TTTT_SSSS_TTTT_AAAA_TTTT_EEEE         If ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE is defined and _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa() is issued
  87.                        in the wrong sequence on the transport endpoint
  88.                        referenced by _ffff_dddd, the _TTTT_OOOO_UUUU_TTTT_SSSS_TTTT_AAAA_TTTT_EEEE error value is returned
  89.                        within the variable _tttt______eeee_rrrr_rrrr_nnnn_oooo.
  90.  
  91.      _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR           A system error has occurred during execution of this
  92.                        function.
  93.  
  94.      _TTTT_BBBB_AAAA_DDDD_DDDD_AAAA_TTTT_AAAA          There are multiple conditions which could cause this
  95.                        _tttt______eeee_rrrr_rrrr_nnnn_oooo to be generated.  One condition is:  _nnnn_bbbb_yyyy_tttt_eeee_ssss is
  96.                        zero and sending zero bytes is not supported by the
  97.                        transport provider.  Another condition is: if
  98.                        ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE is defined and a single send was
  99.                        attempted specifying a _TTTT_SSSS_DDDD_UUUU greater than that specified
  100.                        by the current values of the _TTTT_SSSS_DDDD_UUUU field in the _iiii_nnnn_ffff_oooo
  101.                        argument.
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      _iiii_nnnn_tttt_rrrr_oooo(3N), _ffff_cccc_nnnn_tttt_llll(2), _tttt______aaaa_llll_llll_oooo_cccc(3N), _tttt______oooo_pppp_eeee_nnnn(3N), _tttt______rrrr_cccc_vvvv_uuuu_dddd_aaaa_tttt_aaaa(3N),
  105.      _tttt______rrrr_cccc_vvvv_uuuu_dddd_eeee_rrrr_rrrr(3N)
  106.  
  107. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  108.      _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa returns 0 on successful completion and -1 on failure _tttt______eeee_rrrr_rrrr_nnnn_oooo
  109.      is set to indicate the error.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.